From 0a75bb43530dae36901f3c4c46f2993ad858b754 Mon Sep 17 00:00:00 2001 From: Matthias Clasen Date: Fri, 18 Nov 2016 14:43:34 -0500 Subject: [PATCH] Work towards a clean docs build Remove various no-longer-existing functions from the sections file, and exclude more private headers, etc. --- docs/reference/gtk/Makefile.am | 10 ++ docs/reference/gtk/gtk4-sections.txt | 244 +-------------------------- gtk/gtkbutton.c | 12 +- gtk/gtksnapshot.h | 2 +- 4 files changed, 21 insertions(+), 247 deletions(-) diff --git a/docs/reference/gtk/Makefile.am b/docs/reference/gtk/Makefile.am index 807a408b68..2c0f89020a 100644 --- a/docs/reference/gtk/Makefile.am +++ b/docs/reference/gtk/Makefile.am @@ -31,8 +31,10 @@ IGNORE_HFILES = \ gtkapplicationprivate.h \ gtkbindingsprivate.h \ gtkbitmaskprivate.h \ + gtkboxgadgetprivate.h \ gtkboxprivate.h \ gtkbuilderprivate.h \ + gtkbuiltiniconprivate.h \ gtkbuttonprivate.h \ gtkcairoblurprivate.h \ gtkcellareaboxcontextprivate.h \ @@ -49,12 +51,16 @@ IGNORE_HFILES = \ gtkcssarrayvalueprivate.h \ gtkcssbgsizevalueprivate.h \ gtkcssbordervalueprivate.h \ + gtkcsscalcvalueprivate.h \ gtkcsscolorvalueprivate.h \ gtkcsscornervalueprivate.h \ + gtkcsscustomgadgetprivate.h \ gtkcsscustompropertyprivate.h \ + gtkcssdimensionvalueprivate.h \ gtkcsseasevalueprivate.h \ gtkcssenginevalueprivate.h \ gtkcssenumvalueprivate.h \ + gtkcssgadgetprivate.h \ gtkcssiconthemevalueprivate.h \ gtkcssimagebuiltinprivate.h \ gtkcssimagecrossfadeprivate.h \ @@ -73,8 +79,10 @@ IGNORE_HFILES = \ gtkcsslookupprivate.h \ gtkcssmatcherprivate.h \ gtkcssnodeprivate.h \ + gtkcssnodestylecacheprivate.h \ gtkcssnodedeclarationprivate.h \ gtkcssnumbervalueprivate.h \ + gtkcsspalettevalueprivate.h \ gtkcsspathnodeprivate.h \ gtkcssparserprivate.h \ gtkcsspositionvalueprivate.h \ @@ -119,6 +127,7 @@ IGNORE_HFILES = \ gtkiconhelperprivate.h \ gtkiconviewprivate.h \ gtkimageprivate.h \ + gtkimcontextsimpleprivate.h \ gtkimmoduleprivate.h \ gtklabelprivate.h \ gtklockbuttonprivate.h \ @@ -163,6 +172,7 @@ IGNORE_HFILES = \ gtkstylecontextprivate.h \ gtkstylepropertyprivate.h \ gtkstyleproviderprivate.h \ + gtktextattributes.h \ gtktextattributesprivate.h \ gtktextchildprivate.h \ gtktexthandleprivate.h \ diff --git a/docs/reference/gtk/gtk4-sections.txt b/docs/reference/gtk/gtk4-sections.txt index 1e80560c72..b033a4d169 100644 --- a/docs/reference/gtk/gtk4-sections.txt +++ b/docs/reference/gtk/gtk4-sections.txt @@ -250,24 +250,6 @@ GtkAssistantPrivate gtk_assistant_get_type -
-gtkarrow -GtkArrow -GtkArrow -gtk_arrow_new -gtk_arrow_set - -GTK_ARROW -GTK_IS_ARROW -GTK_TYPE_ARROW -GTK_ARROW_CLASS -GTK_IS_ARROW_CLASS -GTK_ARROW_GET_CLASS - -GtkArrowPrivate -gtk_arrow_get_type -
-
gtkaspectframe GtkAspectFrame @@ -514,27 +496,15 @@ gtk_button_new gtk_button_new_with_label gtk_button_new_with_mnemonic gtk_button_new_from_icon_name -gtk_button_pressed -gtk_button_released gtk_button_clicked -gtk_button_enter -gtk_button_leave gtk_button_set_relief gtk_button_get_relief gtk_button_get_label gtk_button_set_label gtk_button_get_use_underline gtk_button_set_use_underline -gtk_button_set_focus_on_click -gtk_button_get_focus_on_click -gtk_button_set_alignment -gtk_button_get_alignment -gtk_button_set_image -gtk_button_get_image -gtk_button_set_image_position -gtk_button_get_image_position -gtk_button_set_always_show_image -gtk_button_get_always_show_image +gtk_button_set_icon_name +gtk_button_get_icon_name GTK_BUTTON @@ -640,8 +610,6 @@ gtk_check_menu_item_get_type GtkColorButton gtk_color_button_new gtk_color_button_new_with_rgba -gtk_color_button_set_rgba -gtk_color_button_get_rgba gtk_color_button_set_title gtk_color_button_get_title @@ -656,64 +624,6 @@ gtk_color_button_get_type GtkColorButtonPrivate
-
-gtkcolorsel -GtkColorSelection -GtkColorSelection -GtkColorSelectionClass -gtk_color_selection_new -gtk_color_selection_set_has_opacity_control -gtk_color_selection_get_has_opacity_control -gtk_color_selection_set_has_palette -gtk_color_selection_get_has_palette -gtk_color_selection_get_current_alpha -gtk_color_selection_set_current_alpha -gtk_color_selection_get_current_color -gtk_color_selection_set_current_color -gtk_color_selection_get_previous_alpha -gtk_color_selection_set_previous_alpha -gtk_color_selection_get_previous_color -gtk_color_selection_set_previous_color -gtk_color_selection_get_current_rgba -gtk_color_selection_set_current_rgba -gtk_color_selection_get_previous_rgba -gtk_color_selection_set_previous_rgba -gtk_color_selection_is_adjusting -gtk_color_selection_palette_from_string -gtk_color_selection_palette_to_string -GtkColorSelectionChangePaletteFunc -gtk_color_selection_set_change_palette_with_screen_hook -GtkColorSelectionChangePaletteWithScreenFunc - -GTK_COLOR_SELECTION -GTK_IS_COLOR_SELECTION -GTK_TYPE_COLOR_SELECTION -GTK_COLOR_SELECTION_CLASS -GTK_IS_COLOR_SELECTION_CLASS -GTK_COLOR_SELECTION_GET_CLASS - -GtkColorSelectionPrivate -gtk_color_selection_get_type -
- -
-gtkcolorseldlg -GtkColorSelectionDialog -GtkColorSelectionDialog -gtk_color_selection_dialog_new -gtk_color_selection_dialog_get_color_selection - -GTK_COLOR_SELECTION_DIALOG -GTK_IS_COLOR_SELECTION_DIALOG -GTK_TYPE_COLOR_SELECTION_DIALOG -GTK_COLOR_SELECTION_DIALOG_CLASS -GTK_IS_COLOR_SELECTION_DIALOG_CLASS -GTK_COLOR_SELECTION_DIALOG_GET_CLASS - -GtkColorSelectionDialogPrivate -gtk_color_selection_dialog_get_type -
-
gtkcombobox GtkComboBox @@ -747,10 +657,6 @@ gtk_combo_box_popdown gtk_combo_box_get_popup_accessible gtk_combo_box_get_row_separator_func gtk_combo_box_set_row_separator_func -gtk_combo_box_set_add_tearoffs -gtk_combo_box_get_add_tearoffs -gtk_combo_box_set_title -gtk_combo_box_get_title gtk_combo_box_set_button_sensitivity gtk_combo_box_get_button_sensitivity gtk_combo_box_get_has_entry @@ -804,7 +710,6 @@ gtk_combo_box_text_get_type GtkContainer GtkContainer GtkContainerClass -GTK_IS_RESIZE_CONTAINER GTK_CONTAINER_WARN_INVALID_CHILD_PROPERTY_ID gtk_container_add gtk_container_remove @@ -819,7 +724,6 @@ gtk_container_get_focus_vadjustment gtk_container_set_focus_vadjustment gtk_container_get_focus_hadjustment gtk_container_set_focus_hadjustment -gtk_container_resize_children gtk_container_child_type gtk_container_child_get gtk_container_child_set @@ -872,8 +776,6 @@ gtk_dialog_get_widget_for_response gtk_dialog_get_action_area gtk_dialog_get_content_area gtk_dialog_get_header_bar - -gtk_alternative_dialog_button_order GTK_DIALOG @@ -947,7 +849,6 @@ gtk_entry_set_buffer gtk_entry_set_text gtk_entry_get_text gtk_entry_get_text_length -gtk_entry_get_text_area gtk_entry_set_visibility gtk_entry_get_visibility gtk_entry_set_invisible_char @@ -1837,11 +1738,8 @@ gtk_menu_set_accel_group gtk_menu_get_accel_group gtk_menu_set_accel_path gtk_menu_get_accel_path -gtk_menu_set_title -gtk_menu_get_title gtk_menu_set_monitor gtk_menu_get_monitor -gtk_menu_get_tearoff_state gtk_menu_set_reserve_toggle_size gtk_menu_get_reserve_toggle_size @@ -1849,7 +1747,6 @@ gtk_menu_popdown gtk_menu_reposition gtk_menu_get_active gtk_menu_set_active -gtk_menu_set_tearoff_state gtk_menu_attach_to_widget gtk_menu_detach gtk_menu_get_attach_widget @@ -1929,8 +1826,6 @@ GtkMenuItemClass gtk_menu_item_new gtk_menu_item_new_with_label gtk_menu_item_new_with_mnemonic -gtk_menu_item_set_right_justified -gtk_menu_item_get_right_justified gtk_menu_item_get_label gtk_menu_item_set_label gtk_menu_item_get_use_underline @@ -2300,11 +2195,9 @@ gtk_range_set_upper_stepper_sensitivity gtk_range_get_upper_stepper_sensitivity gtk_range_get_flippable gtk_range_set_flippable -gtk_range_get_min_slider_size gtk_range_get_range_rect gtk_range_get_slider_range gtk_range_get_slider_size_fixed -gtk_range_set_min_slider_size gtk_range_set_slider_size_fixed @@ -2752,8 +2645,6 @@ gtk_rc_property_parse_flags gtk_rc_property_parse_requisition gtk_rc_property_parse_border gtk_settings_reset_property -GtkIMPreeditStyle -GtkIMStatusStyle GtkSettingsClass GTK_IS_SETTINGS @@ -2913,24 +2804,6 @@ GtkLevelBarPrivate gtk_level_bar_get_type
-
-gtktearoffmenuitem -GtkTearoffMenuItem -GtkTearoffMenuItem -GtkTearoffMenuItemClass -gtk_tearoff_menu_item_new - -GTK_TEAROFF_MENU_ITEM -GTK_IS_TEAROFF_MENU_ITEM -GTK_TYPE_TEAROFF_MENU_ITEM -GTK_TEAROFF_MENU_ITEM_CLASS -GTK_IS_TEAROFF_MENU_ITEM_CLASS -GTK_TEAROFF_MENU_ITEM_GET_CLASS - -GtkTearoffMenuItemPrivate -gtk_tearoff_menu_item_get_type -
-
gtktextbuffer GtkTextBuffer @@ -3301,30 +3174,6 @@ gtk_text_child_anchor_get_type GtkTextBTree
-
-gtktoggleaction -GtkToggleAction -GtkToggleAction -gtk_toggle_action_new -gtk_toggle_action_toggled -gtk_toggle_action_set_active -gtk_toggle_action_get_active -gtk_toggle_action_set_draw_as_radio -gtk_toggle_action_get_draw_as_radio - - -GTK_TYPE_TOGGLE_ACTION -GTK_TOGGLE_ACTION -GTK_TOGGLE_ACTION_CLASS -GTK_IS_TOGGLE_ACTION -GTK_IS_TOGGLE_ACTION_CLASS -GTK_TOGGLE_ACTION_GET_CLASS -GtkToggleActionClass - -gtk_toggle_action_get_type -GtkToggleActionPrivate -
-
gtktogglebutton GtkToggleButton @@ -4140,7 +3989,6 @@ gtk_cell_view_set_model gtk_cell_view_get_model gtk_cell_view_set_displayed_row gtk_cell_view_get_displayed_row -gtk_cell_view_set_background_color gtk_cell_view_set_background_rgba gtk_cell_view_set_draw_sensitive gtk_cell_view_get_draw_sensitive @@ -4627,7 +4475,6 @@ GtkWidgetClass GtkCallback GtkRequisition GtkAllocation -GtkWidgetHelpType gtk_widget_new gtk_widget_destroy gtk_widget_in_destruction @@ -4680,16 +4527,9 @@ gtk_widget_set_device_enabled gtk_widget_get_device_enabled gtk_widget_get_toplevel gtk_widget_get_ancestor -gtk_widget_get_visual -gtk_widget_set_visual gtk_widget_is_ancestor gtk_widget_translate_coordinates gtk_widget_hide_on_delete -gtk_widget_set_style -gtk_widget_ensure_style -gtk_widget_get_style -gtk_widget_reset_rc_styles -gtk_widget_get_default_style gtk_widget_set_direction GtkTextDirection gtk_widget_get_direction @@ -4697,21 +4537,6 @@ gtk_widget_set_default_direction gtk_widget_get_default_direction gtk_widget_shape_combine_region gtk_widget_input_shape_combine_region -gtk_widget_path -gtk_widget_class_path -gtk_widget_override_background_color -gtk_widget_override_color -gtk_widget_override_font -gtk_widget_override_symbolic_color -gtk_widget_override_cursor -gtk_widget_modify_style -gtk_widget_get_modifier_style -gtk_widget_modify_fg -gtk_widget_modify_bg -gtk_widget_modify_text -gtk_widget_modify_base -gtk_widget_modify_font -gtk_widget_modify_cursor gtk_widget_create_pango_context gtk_widget_get_pango_context gtk_widget_set_font_options @@ -4719,8 +4544,6 @@ gtk_widget_get_font_options gtk_widget_set_font_map gtk_widget_get_font_map gtk_widget_create_pango_layout -gtk_widget_render_icon -gtk_widget_render_icon_pixbuf gtk_widget_queue_draw_area gtk_widget_queue_draw_region gtk_widget_set_redraw_on_allocate @@ -4728,12 +4551,10 @@ gtk_widget_mnemonic_activate gtk_widget_class_install_style_property gtk_widget_class_find_style_property gtk_widget_class_list_style_properties -gtk_widget_region_intersect gtk_widget_send_focus_change gtk_widget_style_get gtk_widget_style_get_property gtk_widget_style_get_valist -gtk_widget_style_attach gtk_widget_class_set_accessible_type gtk_widget_class_set_accessible_role gtk_widget_get_accessible @@ -4790,7 +4611,6 @@ gtk_widget_get_has_window gtk_widget_set_has_window gtk_widget_get_sensitive gtk_widget_is_sensitive -GtkStateType gtk_widget_get_visible gtk_widget_is_visible gtk_widget_set_visible @@ -4801,7 +4621,6 @@ gtk_widget_has_default gtk_widget_has_focus gtk_widget_has_visible_focus gtk_widget_has_grab -gtk_widget_has_rc_style gtk_widget_is_drawable gtk_widget_is_toplevel gtk_widget_set_window @@ -4910,7 +4729,6 @@ GtkWindowClass GtkWindowType gtk_window_new gtk_window_set_title -gtk_window_set_wmclass gtk_window_set_resizable gtk_window_get_resizable gtk_window_add_accel_group @@ -4919,8 +4737,6 @@ gtk_window_activate_focus gtk_window_activate_default gtk_window_set_modal gtk_window_set_default_size -gtk_window_set_default_geometry -gtk_window_set_geometry_hints gtk_window_set_gravity gtk_window_get_gravity GtkWindowPosition @@ -4999,10 +4815,7 @@ gtk_window_get_group gtk_window_has_group gtk_window_get_window_type gtk_window_move -gtk_window_parse_geometry -gtk_window_reshow_with_initial_size gtk_window_resize -gtk_window_resize_to_geometry gtk_window_set_default_icon_list gtk_window_set_default_icon gtk_window_set_default_icon_from_file @@ -5192,8 +5005,6 @@ GTK_STYLE_PROVIDER_PRIORITY_THEME GTK_STYLE_PROVIDER_PRIORITY_SETTINGS GTK_STYLE_PROVIDER_PRIORITY_APPLICATION GTK_STYLE_PROVIDER_PRIORITY_USER -gtk_style_provider_get_icon_factory -gtk_style_provider_get_style gtk_style_provider_get_style_property GTK_TYPE_STYLE_PROVIDER @@ -5328,13 +5139,10 @@ gtk_style_context_get_border_color gtk_style_context_get_border gtk_style_context_get_padding gtk_style_context_get_margin -gtk_style_context_get_font -gtk_style_context_state_is_running gtk_style_context_lookup_color gtk_style_context_remove_provider gtk_style_context_remove_provider_for_screen gtk_style_context_reset_widgets -gtk_style_context_set_background gtk_style_context_restore gtk_style_context_save gtk_style_context_set_junction_sides @@ -5433,47 +5241,6 @@ gtk_css_provider_error_quark gtk_css_section_get_type
-
-gtksymboliccolor -GtkSymbolicColor -GtkSymbolicColor -gtk_symbolic_color_new_literal -gtk_symbolic_color_new_name -gtk_symbolic_color_new_shade -gtk_symbolic_color_new_alpha -gtk_symbolic_color_new_mix -gtk_symbolic_color_new_win32 -gtk_symbolic_color_ref -gtk_symbolic_color_unref -gtk_symbolic_color_resolve -gtk_symbolic_color_to_string - - -GTK_TYPE_SYMBOLIC_COLOR - - -gtk_symbolic_color_get_type -
- -
-gtkgradient -GtkGradient -GtkGradient -gtk_gradient_new_linear -gtk_gradient_new_radial -gtk_gradient_add_color_stop -gtk_gradient_ref -gtk_gradient_unref -gtk_gradient_resolve -gtk_gradient_resolve_for_context -gtk_gradient_to_string - - -GTK_TYPE_GRADIENT - -gtk_gradient_get_type -
-
gtkselection Selections @@ -5597,7 +5364,6 @@ GtkTargetFlags GtkDragResult gtk_drag_dest_set -gtk_drag_dest_set_proxy gtk_drag_dest_unset gtk_drag_dest_find_target gtk_drag_dest_get_target_list @@ -5613,7 +5379,6 @@ gtk_drag_get_source_widget gtk_drag_highlight gtk_drag_unhighlight -gtk_drag_begin gtk_drag_begin_with_coordinates gtk_drag_cancel gtk_drag_set_icon_widget @@ -5653,7 +5418,6 @@ gtk_binding_entry_add_signal gtk_binding_entry_add_signal_from_string gtk_binding_entry_skip gtk_binding_entry_remove -gtk_binding_set_add_path
@@ -6267,7 +6031,7 @@ gtk_mount_operation_get_parent gtk_mount_operation_set_screen gtk_mount_operation_get_screen gtk_show_uri -gtk_show_uri_on_parent +gtk_show_uri_on_window GTK_IS_MOUNT_OPERATION GTK_IS_MOUNT_OPERATION_CLASS @@ -6907,8 +6671,6 @@ gtk_popover_set_constrain_to gtk_popover_get_constrain_to gtk_popover_set_modal gtk_popover_get_modal -gtk_popover_set_transitions_enabled -gtk_popover_get_transitions_enabled gtk_popover_set_default_widget gtk_popover_get_default_widget diff --git a/gtk/gtkbutton.c b/gtk/gtkbutton.c index 78e94d66ef..900b9bd41c 100644 --- a/gtk/gtkbutton.c +++ b/gtk/gtkbutton.c @@ -1181,9 +1181,9 @@ gtk_button_set_label (GtkButton *button, * @button: a #GtkButton * * Fetches the text from the label of the button, as set by - * gtk_button_set_label(). If the label text has not - * been set the return value will be %NULL. This will be the - * case if you create an empty button with gtk_button_new() to + * gtk_button_set_label(). If the label text has not + * been set the return value will be %NULL. This will be the + * case if you create an empty button with gtk_button_new() to * use as a container. * * Returns: (nullable): The text of the label widget. This string is owned @@ -1246,7 +1246,7 @@ gtk_button_set_use_underline (GtkButton *button, * @button: a #GtkButton * * Returns whether an embedded underline in the button label indicates a - * mnemonic. See gtk_button_set_use_underline (). + * mnemonic. See gtk_button_set_use_underline(). * * Returns: %TRUE if an embedded underline in the button label * indicates the mnemonic accelerator keys. @@ -1380,7 +1380,9 @@ gtk_button_set_icon_name (GtkButton *button, * gtk_button_get_icon_name: * @button: A #GtkButton * - * Returns: (nullable): The icon name set via gtk_button_set_icon_name + * Returns the icon name set via gtk_button_set_icon_name(). + * + * Returns: (nullable): The icon name set via gtk_button_set_icon_name() * * Since: 3.90 */ diff --git a/gtk/gtksnapshot.h b/gtk/gtksnapshot.h index 73219adaeb..0bfaa54967 100644 --- a/gtk/gtksnapshot.h +++ b/gtk/gtksnapshot.h @@ -63,7 +63,7 @@ void gtk_snapshot_set_transform (GtkSnapshot const graphene_matrix_t *transform); GDK_AVAILABLE_IN_3_90 void gtk_snapshot_transform (GtkSnapshot *snapshot, - const graphene_matrix_t *matrix); + const graphene_matrix_t *transform); GDK_AVAILABLE_IN_3_90 void gtk_snapshot_translate_2d (GtkSnapshot *snapshot, int x, -- 2.30.2